<?xml version="1.0" encoding="UTF-8"?>
<!--
  ~ Copyright 2010 Mark Slater
  ~
  ~ Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
  ~
  ~ 	http://www.apache.org/licenses/LICENSE-2.0
  ~
  ~ Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
  -->

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
    <title>Argo - A simple JSON parser and generator for Java</title>
    <link rel="stylesheet" type="text/css" href="argo.css"/>
    <link rel="icon" type="image/png" href="/favicon-32x32.png" />
    <meta name="description" content="Argo is an open source JSON parser and generator written in Java.  It offers document, push, and pull APIs.  It is free to download and use in your project."/>
    <meta name="verify-v1" content="8/1zmu6pwHM286FJ1VE9nWTdr1SF5VE819uJDcFXTj4="/>
</head>
<body>
<div id="root">
    <div id="header">
        <h1>Argo</h1>
    </div>
    <div id="navigation">
        <ul>
            <li><a href="index.html">Home</a></li>
            <li><a href="downloads.html">Downloads</a></li>
            <li><a href="documentation.html">Documentation</a></li>
            <li><a href="support.html">Support</a></li>
            <li><a href="https://sourceforge.net/projects/argo/">Project Site</a></li>
        </ul>
    </div>
    <div id="content">
        <h2>Introduction</h2>
        <p>Argo is a JSON parser and generator for Java. It offers three parse interfaces - a push parser, a pull
            parser, and a DOM syle parser.  It is written to be easy to use, typesafe, and fast.  It is open source, and
            free for you to use.</p>

        <p>The latest version of Argo available for download is <a
                href="https://sourceforge.net/projects/argo/files/latest">@VERSION@</a>.
            The <a href="javadoc/">javadoc</a> is also available online.</p>
        <h2>Example</h2>
        <p>A brief example demonstrates the DOM style parser.  The example is based on the following JSON, which is
        assumed to be available in a <code>String</code> called <code>jsonText</code>.</p>
        <div class="code">{
    "name": "Black Lace",
    "sales": 110921,
    "totalRoyalties": 10223.82,
    "singles": [
        "Superman", "Agadoo"
    ]
}</div>
        <p>We can use Argo to get the second single like this:</p>
        <div class="code">String secondSingle = new JdomParser().parse(jsonText)
    .getStringValue("singles", 1);</div>
        <p>On the first line, we parse the JSON text into an object hierarchy.  There are various options for navigating
            this, but the simplest is just to give the path and type of node we expect.</p>
        <p>On line two, we ask for the JSON string at index 1 of the array in the
            <code>singles</code> field.</p>
        <p>If we check the <code>secondSingle</code> variable, we will find, as expected, it contains the
            <code>String</code> "<code>Agadoo</code>".
        </p>
    </div>
    <div id="footer">
        <ul>
            <li>
                <a href="http://sourceforge.net/projects/argo">
                    <img src="http://sflogo.sourceforge.net/sflogo.php?group_id=245339&amp;type=13"
                         alt="Get Argo at SourceForge.net. Fast, secure and Free Open Source software downloads"
                         height="30" width="120"/>
                </a>
            </li>
            <li>
                <a href="http://jigsaw.w3.org/css-validator/check/referer">
                    <img src="http://jigsaw.w3.org/css-validator/images/vcss" alt="Valid CSS!" height="31" width="88"/>
                </a>
            </li>
            <li>
                <a href="http://validator.w3.org/check?uri=referer">
                    <img src="http://www.w3.org/Icons/valid-xhtml10" alt="Valid XHTML 1.0 Strict" height="31"
                         width="88"/>
                </a>
            </li>
        </ul>
    </div>
</div>
<div>
    <!-- Piwik -->
    <script type="text/javascript" src="piwik_1.js"></script>
    <script type="text/javascript" src="piwik_2.js"></script>
    <object>
        <noscript><p><img src="http://sourceforge.net/apps/piwik/argo/piwik.php?idsite=1" alt="piwik"/></p></noscript>
    </object>
    <!-- End Piwik Tag -->
</div>
</body>
</html>
